Summary

This PR adds an optional nickname parameter when placing orders. When provided, the burger-webapp dashboard displays the first 10 characters of the nickname instead of the order ID, making it easier for customers to identify their orders.

Changes

Display Behavior

Before: Orders always showed the last 6 characters of the auto-generated order ID with # prefix (e.g., #abcdef)

After: Orders show the first 10 characters of the nickname if provided (e.g., Alice without # prefix), otherwise fall back to the order ID with # prefix (e.g., #abcdef)

Implementation

Added nickname as an optional field throughout the order lifecycle:

API Layer:

• Extended Order interface with nickname?: string
• Updated CreateOrderRequest to accept optional nickname
• Modified order creation to store nickname when provided
• Updated OpenAPI specification with complete documentation

Frontend Layer:

• Added nickname to BurgerOrder interface
• Updated dashboard rendering logic to prioritize nickname display:

  const displayId = order.nickname ? order.nickname.slice(0, 10) : `#${order.id.slice(-6)}`;

  • Nicknames display without # prefix
  • Order ID fallback displays last 6 chars with # prefix

MCP Layer:

• Extended place_order tool schema to accept optional nickname parameter
• Enables AI agents to use nicknames when placing orders

Example Usage

POST /api/orders
Content-Type: application/json

{
  "userId": "user123",
  "nickname": "Alice",
  "items": [
    {
      "burgerId": "1",
      "quantity": 2
    }
  ]
}

Backward Compatibility

✅ Fully backward compatible - The nickname parameter is optional, so all existing code and integrations continue to work without any changes. Orders without nicknames display exactly as before.

Files Changed

• packages/burger-api/src/order.ts
• packages/burger-api/src/functions/orders-post.ts
• packages/burger-api/openapi.yaml
• packages/burger-api/api.http
• packages/burger-webapp/src/orders.service.ts
• packages/burger-webapp/src/components/burger-dashboard.ts
• packages/burger-mcp/src/tools.ts

Fixes #3

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.